home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / mus / play / splib43U.lha / superplay-lib_USR / Docs / SPObject-Docs / ST.doc < prev    next >
Text File  |  1994-12-13  |  7KB  |  182 lines
  1.  
  2.   ST.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 2.1
  9.   Release Date : 11.12.1994
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   ST.svobject is an external Library-Module for the superplay.library V1+.
  15.  
  16.   It supports reading of ST Modules (SoundTracker V2.4+, ProTracker V2.2a,
  17.   NoiseTracker and compatible Modules).
  18.  
  19.  
  20.   Requirements
  21.   ~~~~~~~~~~~~
  22.   - OS V2.04+ (V37)+ and its libraries
  23.   - for reading of packed modules, either xpkmaster.library or
  24.     powerpacker.library is needed :
  25.  
  26.     Packer      needed Libraries
  27.     XPK            xpkmaster.library V2+, speficic xpk-compressor libraries
  28.     PP20        a) xpkmaster.library V2+, powerpacker.library V33+
  29.                 b) _only_ powerpacker.library V33+
  30.     <None>      <no special libraries are needed, but they will simply pass
  31.                  through unpacked data modules>
  32.  
  33.  
  34.   Remarks
  35.   ~~~~~~~
  36.    - As with other Players, the filename of the Module has to begin
  37.      or end with the prefix/entension "MOD" ("MOD.module" or "module.MOD")
  38.    - ST.spobject at first tries to use xpkmaster.library.
  39.      If this one is not available, it tries powerpacker.library.
  40.      If none of them is available, it simply uses dos.library :
  41.      So, if you read a packed module, although you did not install any
  42.      decompression libraries, please note the following :
  43.      After loading the data is checked, so that modules which could
  44.      not be decompressed are rejected without any further notice.
  45.  
  46.  
  47.   Author
  48.   ~~~~~~
  49.   Andreas R. Kleinert
  50.   Grube Hohe Grethe 23
  51.   D-57074 Siegen
  52.   Germany
  53.  
  54.  
  55.   Credits
  56.   ~~~~~~~
  57.   The "powerpacker.library" V33+ is (C)opyright by Nico François.
  58.   The Library is FREEWARE and is needed by ST.spobject, to be able
  59.   to read and play also PP20-packed Modules.
  60.  
  61.   The "xpkmaster.library" V2+ is (C)opyright by its authors
  62.   (c/o Urban Dominik Müller).
  63.   The Library is freely distributable and is needed by ST.spobject,
  64.   to be able to read and play XPK-packed Modules.
  65.  
  66.   Upto V1.2 the main Player Source-Code in Assembler was taken from
  67.   the Public Domain Library "STReplay" by Oliver Wagner, which can be
  68.   found on AmigaLib-Disk #258.
  69.   Oliver said in the Docs to STReplay, that he did not obtain any rights
  70.   to the Source, so I used it for my own purposes.
  71.   Nevertheless I did not just "include" the Source, but made many - more
  72.   or less useful and important - changes to it.
  73.  
  74.   Since V1.3 the new ProTracker V2.2a Player Routine is used.
  75.   I got it from Gerd Frank (thanks Gerd !) and modified it for my own
  76.   purposes : Some changes had to be made to assemble it with the SAS/C
  77.   ASM V6.5 and to make it living in the multitasking better than before.
  78.   Finally, I had to change and add some more code to create an interface
  79.   to the C-SourceCode of the SPObject's main routines.
  80.  
  81.   Here's an excerpt from the SourceCode as far as concerning the original
  82.   authors (no special copyright notice was found, so it is perhaps
  83.   Public Domain) :
  84.  
  85.   * ProTracker2.2a replay routine by Crayon/Noxious. Improved and modified
  86.   * by Teeme of Fist! Unlimited in 1992. Share and enjoy! :)
  87.   * Rewritten for Devpac (slightly..) by CJ.
  88.  
  89.  
  90.   History
  91.   ~~~~~~~
  92.   V2.2 (11.12.1994) :
  93.  
  94.    - extraction of samples only worked with modules, which had been
  95.      XPK-packed. Now also PP20 or unpacked modules can be handled.
  96.  
  97.  
  98.   V2.1 (18.07.1994) :
  99.  
  100.    - fixed BAD BUG in file-recognition routine, which may have caused
  101.      this SPObject crashing very often, if
  102.        a) this SPObject was not very late in the list of SPObjects
  103.        b) this SPObject was late in the list, but an unknown
  104.           FileType was selected e.g. in "SuperPlay"
  105.    - integrated new "SampleList"-Functions for exporting more than one
  106.      sample
  107.    - so extraction of samples from modules now is possible
  108.      (see Example-Programs "SampleListDemo" and "SampleListPlay" for
  109.       detailed information on how to use this functions)
  110.  
  111.  
  112.   V1.6 (19.06.1994) :
  113.  
  114.    - added check for Module type "M!K!", which is Noise/ProTracker with
  115.      100 patterns (thanks to Gerd Frank for reporting this)
  116.  
  117.  
  118.   V1.5 (17.05.1994) :
  119.  
  120.    - use of SAS/C V6.51
  121.    - version still reflected 1.3 instead 1.4. Now we're at 1.5 :-)
  122.    - now "MOD" is either accepted to be the filename's prefix
  123.      ("MOD.ModuleName") or suffix ("ModuleName.MOD").
  124.      This is done, because many modules - e.g. those ported from MS-DOS -
  125.      are named so and we have no other method of identifying them.
  126.    - ST.spobject is no longer dependent on xpkmaster.library :
  127.      now we also use powerpacker.library, if available.
  128.      If no decompression library is installed, we simply try dos.library.
  129.      After loading the data is checked, so that modules which could
  130.      not be decompressed are rejected without any further notice.
  131.    - now checks Module-Type of Files and rejects files, which contain
  132.      IDs other than "M.K." or "FLT4" at the specific offset
  133.  
  134.  
  135.   V1.4 (30.04.1994) :
  136.  
  137.    - version still was V1.2 in V1.3, now we reflect V1.4
  138.    - fixed (hopefully) "header not located" problems within memory
  139.      delocation
  140.  
  141.  
  142.   V1.3 (30.03.1994) :
  143.  
  144.    - replaced old ST Player Routine with new ProTracker V2.2a Player Routine
  145.    - added ST-Module structure definition to Headerfile :
  146.      now it is possible to read the file information without
  147.      playing around with Hex-Offsets.
  148.    - used new STHeader-Definition to print out more information
  149.      about the Module, when calling SPL_FileInfoRequest() :
  150.  
  151.       - SongName
  152.       - Module-Type : "M.K.", "FLT4", ...
  153.       - Number of Instruments (determined by checking InstrLength)
  154.       - Names of Instruments and hidden strings (even if more than
  155.         the nominal number)
  156.         This was a little bit tricky sometimes, but now it works with
  157.         all modules without crashing the Amiga !
  158.         Enjoy reading the "hidden messages" of ST-Files and find out
  159.         the authors of previous "no name"-modules.
  160.    - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
  161.      This saves about 1800 Bytes.
  162.    - now using Utility-Library for integer operations (activated
  163.      SAS/C's UTILLIB option) : this increases 68000-codesize a little
  164.      bit, but increases speed on 68020+ systems
  165.      (should also decrease codesize, but does not ...)
  166.  
  167.  
  168.   V1.2 (25.02.1994) :
  169.  
  170.    - fixed small bug in memory management routines
  171.  
  172.  
  173.   V1.1 (16.01.1994) :
  174.  
  175.    - first version
  176.  
  177.  
  178.   Copyrights
  179.   ~~~~~~~~~~
  180.   Some of the mentioned names or products above may be copyrighted by
  181.   companies or trademarks of companies.
  182.